Pagos y Transferencias
La API de Pagos y transferencias permite que usted efectúe pagos de diversos tipos y realice transferencias de PIX, TED, TEF. Esta API también permite realizar la cancelación y el listado de los pagos y transferencias.
Casos de Uso
- Ofrecer en el sistema la capacidad de iniciar pagos.
- Monitoreo de los estados de los pagos dentro de un sistema.
- Gestión de lotes de pagos.
Cómo funcionan los pagos
En el ecosistema de APIs de BTG Empresas, las solicitudes crearán "iniciaciones de pago". Estas iniciaciones deberán ser aprobadas vía internet banking o aplicación mobile por las partes necesarias, respetando las cuestiones de firmas y poderes de la empresa.
En otras palabras, al utilizar la API el dinero no se moviliza de forma instantánea, sino después de la aprobación realizada vía aplicación mobile o internet banking.
Existe la posibilidad de aprobaciones unitarias o en lote, así como la creación de "iniciaciones de pago" unitarias o en lote.
Modalidades de pagos y transferencias
La API de pagos y transferencias ofrece una serie de modalidades de pago, que se diferencian entre sí únicamente en los datos enviados en el cuerpo de la solicitud dentro del objeto details y en el tipo seleccionado.
PIX_QR_CODE
Esta modalidad exige que se informe dentro del details el emv, también llamado código de copia y pega, del QR code. Esta modalidad crea una iniciación de un pago o transferencia del tipo PIX.
BANKSLIP
Esta modalidad exige que se informe dentro del details la línea digitable digitableLine del boleto a pagar. No acepta líneas digitables que se inician con 8
UTILITIES
Esta modalidad exige que se informe dentro del details la línea digitable digitableLine o código de barras barcode de la guía a pagar.
Las guías elegibles para el tipo UTILITIES son aquellas cuyo código de identificación mencionado en el párrafo anterior se inicia con el dígito 8. Como por ejemplo DARFs, cuentas de agua/luz, etc...
TED y PIX_MANUAL
Esta modalidad exige que se informe dentro del details la información de la cuenta del beneficiario del pago o transacción. El tipo del pago o transferencia depende del tipo informado:
- PIX_MANUAL consiste en un PIX
- TED consiste en un TED o TEF según lo que se informe.
PIX_KEY
Esta modalidad exige que se informe dentro del details una clave pix válida de cualquier tipo. Origina un pago o transferencia del tipo PIX
DARF
Esta modalidad exige que se informe dentro del details la información del documento a pagar.
PIX_REVERSAL
Esta modalidad exige que se informe dentro del details el originalEndToEndId del pix recibido. Esta modalidad consiste en una devolución de un pix recibido a la cuenta desde donde se originó la transacción.
Recursos Disponibles
Los recursos de la API de pagos y transferencias están disponibles en el API Reference.